home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload Trio 2 / Shareware Overload Trio Volume 2 (Chestnut CD-ROM).ISO / dir31 / datime10.zip / DATIME.DOC < prev    next >
Text File  |  1994-01-06  |  15KB  |  384 lines
  1.            /----------\
  2.           |    TAG     |  Presents
  3.           |  SOFTWARE  |     . . . . Digital Audio Time 1.0
  4.            \----------/
  5.  
  6.      Digital Audio Time 1.0 is a program that speaks the current
  7.      time on your Sound Blaster, AdLib Personal Computer
  8.      Music System, Disney Sound Source, PC Speaker, or 100%
  9.      compatibles.
  10.  
  11.      Digital Audio Time 1.0 requires an IBM PC or compatible, a
  12.      Sound Blaster, AdLib Personal Computer Music System, Disney
  13.      Sound Source or 100% compatibles, and only 256K of available
  14.      RAM.
  15.      
  16.      Digital Audio Time 1.0 is distributed as Shareware: if you
  17.      like the program, please become a registered user.  See the
  18.      Section "Registration Benefits" at the end of this file for
  19.      more information.  Print or list the file REGISTER.DOC for
  20.      ordering information. Distribution of this shareware program
  21.      is encouraged. 
  22.  
  23.      The Digital Audio Time 1.0 source code, object code,
  24.      executables and manuals on paper or on disk, are COPYRIGHT
  25.      (c) 1993 by Carole & Allen Grider. 
  26.  
  27.      DISCLAIMER
  28.  
  29.      This program is provided "AS IS" and it is WITHOUT warranty
  30.      of any kind that it will work correctly in any or all
  31.      situations. No liability shall be assumed for direct or
  32.      consequential damage caused by the use of this software.
  33.      The only claim TAG SOFTWARE makes is that there are no
  34.      intentional bugs or fatal errors in any original copy of
  35.      the program that you receive directly from TAG SOFTWARE. 
  36.  
  37.      MANIFEST
  38.      
  39.          DATIME.DOC . . . . Text, Documentation (This file)
  40.          DATIME.EXE . . . . Digital Audio Time 1.0 executable
  41.          README.DOC . . . . Text, Last minute information
  42.          DATALARM.DOC . . . How to use DATIME with Telemate 4.0
  43.          TMALARM.BAT  . . . Telemate external alarm example .BAT file
  44.          REGISTER.DOC . . . Text, Registration order form
  45.      CATALOG.DOC  . . . Text, Catalog of TAG SOFTWARE Products
  46.  
  47.      DISTRIBUTION
  48.      
  49.      Distribution of this program is encouraged as long as the
  50.      following Shareware principles are observed:
  51.  
  52.           All of the above-mentioned 7 files should be
  53.           included in the distributed disk and should not be
  54.           altered in any way. TAG SOFTWARE authorizes the
  55.           distribution ONLY of the 7 above-mentioned files.
  56.      
  57.      If archiving this program for BBS use or library use,
  58.      please include all files and use the name: DATIME10, ( e.g.:
  59.      DATIME10.ARC or DATIME10.ZIP ).  This will provide
  60.      consistency for future updates. 
  61.  
  62.      Note for Disk and Rack Vendors: Please contact TAG SOFTWARE
  63.      for the latest version of this and all our programs.  Disk
  64.      and Rack Vendors are allowed to include their own
  65.      installation package.  Also contact us if you require
  66.      customization.  We will consider non-exclusive registration
  67.      handling agreements. 
  68.  
  69.      Rack Vendors: Please contact TAG SOFTWARE regarding discounts
  70.      to your customers for registering our shareware.  We will
  71.      consider discounting some or all of the rack price from our
  72.      registration fee, if we receive some kind of proof-of-purchase. 
  73.  
  74.      SYSTEM REQUIREMENTS AND OPTIONS
  75.      
  76.      COMPUTERS:   IBM/PC/XT/AT or compatibles.  256K free memory.
  77.      SOUND CARD:  Sound Blaster, AdLib Personal Computer Music
  78.                   System, Disney Sound Source or 100% compatibles.
  79.      
  80.      OPERATION
  81.  
  82.      Digital Audio Time is invoked from the MSDOS command line
  83.      or batch file:
  84.  
  85.          DATIME [ -a ] [ -d ] [ -p ]
  86.  
  87.      Options:
  88.          -a    Speak the time on a Sound Blaster in AdLib FM mode.
  89.                May be required on some Sound Blaster clones. 
  90.  
  91.          -d    Speak the time on a Disney Sound Source connected to
  92.                your parallel port (LPT1).
  93.  
  94.          -p    Speak the time on your PC Speaker.
  95.  
  96.      DATIME 1.0 should auto-detect both the Sound Blaster and AdLib
  97.      sound cards.  The Sound Source cannot be detected.  You must
  98.      use the -d option to speak on this device.  If DATIME 1.0 does
  99.      not detect a sound card, it attempts to speak on the PC
  100.      Speaker.  See the NOTES ON SOUND CARDS section below.
  101.  
  102.      DATIME 1.0 will display and speak the time as follows:
  103.  
  104.           "The time is" "HH:MM" [ "PM" ]
  105.  
  106.      Where "HH" will be the hour and "MM" will be the minute.
  107.      "PM" will be added when the time is post meridiem.
  108.  
  109.      Examples:
  110.  
  111.          C:> DATIME
  112.      Digital Audio Time version 1.0
  113.      COPYRIGHT (c) 1993 by Allen & Carole Grider
  114.      Shareware version - Continued use requires registration
  115.      The time is  3:33 PM
  116.  
  117.      Speaks the time on a Sound Blaster, AdLib, or PC Speaker.
  118.  
  119.          C:> DATIME -p
  120.      Digital Audio Time version 1.0
  121.      COPYRIGHT (c) 1993 by Allen & Carole Grider
  122.      Shareware version - Continued use requires registration
  123.      The time is  3:33 PM
  124.  
  125.      Speaks the time on the PC Speaker.
  126.  
  127.      CONFIGURATION
  128.  
  129.      Sound Blaster CONFIGURATION
  130.  
  131.      An environment variable can be used to inform DATIME of the
  132.      information it requires to speak on the Sound Blaster.  This
  133.      environment variable is set up by newer versions of the Sound
  134.      Blaster's installation program, but older Sound Blaster's
  135.      (and clone's) installation programs do not set up this
  136.      environment variable.
  137.  
  138.      Digital Audio Time can obtain its configuration from the
  139.      environment variable BLASTER.  The format of the information
  140.      in this variable is as follows:
  141.  
  142.          SET BLASTER=Annn In Dn Tn 
  143.  
  144.      Where:
  145.  
  146.          Annn    nnn specifies the I/O Address of your sound card.
  147.  
  148.           Sound Blaster 1.0, 1.5, and 2.0:
  149.           Possible values: 210, 220, 230, 240, 250, 260
  150.          Factory Default: 220 (if not changed via hardware jumper).
  151.  
  152.          Sound Blaster Pro:
  153.           Possible values: 220, 240
  154.          Factory Default: 220 (if not changed via hardware jumper).
  155.  
  156.          Sound Blaster 16:
  157.           Possible values: 220, 240, 260, 280
  158.          Factory Default: 220 (if not changed via hardware jumper).
  159.  
  160.          In      n specifies the IRQ of your sound card.
  161.  
  162.           Sound Blaster 1.0, 1.5, and 2.0:
  163.           Possible values: 2, 3, 5, 7
  164.          Factory Default: 7 (if not changed via hardware jumper).
  165.  
  166.           Sound Blaster Pro
  167.           Possible values: 2, 5, 7, 10
  168.          Factory Default: 7 (if not changed via hardware jumper).
  169.  
  170.           Sound Blaster 16
  171.           Possible values: 2, 5, 7, 10
  172.          Factory Default: 5 (if not changed via hardware jumper).
  173.  
  174.          Dn     n specifies the 8-bit DMA Channel used by your sound card.
  175.  
  176.           Sound Blaster 1.0, 1.5, and 2.0:
  177.           Possible values: 1
  178.          Factory Default: 1 (not changable)
  179.  
  180.           Sound Blaster Pro
  181.           Possible values: 0, 1, 3
  182.          Factory Default: 1
  183.  
  184.           Sound Blaster 16
  185.           Possible values: 0, 1, 3
  186.          Factory Default: 1 (not changable)
  187.  
  188.          Note that DATIME 1.0 only supports DMA channel 1.
  189.  
  190.      Tn     n specifies the Type of your sound card.
  191.          See NOTES ON SOUND CARDS below for more information.
  192.          Possible values:
  193.              1        Sound Blaster 1.0 or 1.5
  194.              2        Sound Blaster Pro
  195.              3        Sound Blaster 2.0
  196.              6        Sound Blaster 16
  197.                  Currently DATIME does nothing with this value.
  198.  
  199.      For a Sound Blaster just out of the box (before you muck with
  200.      the jumpers) use:
  201.  
  202.          SET BLASTER=A220 I7 D1 T1
  203.  
  204.      or:
  205.  
  206.          SET BLASTER=A220 I7 D1 T3
  207.  
  208.      For a Sound Blaster 1.5 (what we have) on IRQ 5 (like us, most
  209.      people have a printer on IRQ 7):
  210.  
  211.           SET BLASTER=A220 I5 D1 T1
  212.  
  213.      The Sound Blaster Pro and Sound Blaster 16 supports
  214.      additional DMA Channels.  However, Digital Audio Time does
  215.      not support the additional DMA Channels.  If your card's
  216.      configuration fits the ranges given above, then Digital Audio
  217.      Time 1.0 should work.  If you have problems, please
  218.      contact us.
  219.  
  220.      Digital Audio Time 1.0 has the ability to auto-detect the
  221.      Sound Blaster.  But, if it has trouble (please let us know)
  222.      you can set the BLASTER environment variable to get around
  223.      the problem.
  224.  
  225.      AdLib CONFIGURATION
  226.  
  227.      Digital Audio Time 1.0 has the ability to auto-detect the
  228.      AdLib Personal Computer Music System sound card.
  229.  
  230.      Disney Sound Source CONFIGURATION
  231.  
  232.      Digital Audio Time 1.0 cannot auto-detect the Sound Source.
  233.      You have to inform it that a Sound Source exists on your
  234.      system.  Use to "-d" option to do this.  For example:
  235.  
  236.          DATIME -D BUGSBUNY.VOC
  237.  
  238.      PC Speaker CONFIGURATION
  239.  
  240.      Digital Audio Time 1.0 assumes a IBM PC/XT/AT clone
  241.      speaker.  If you have a Sound Blaster or AdLib sound card you
  242.      can override DATIME's autodetection and speak the time on
  243.      the PC Speaker by using the "-p" option.
  244.  
  245.      NOTES ON SOUND CARDS
  246.  
  247.      Creative Labs Sound Blaster
  248.  
  249.      Creative Labs has issued several different sound cards - all
  250.      under the name Sound Blaster.  There is also the Sound Blaster
  251.      Pro and the Sound Blaster 16.  The cards and their differences
  252.      are listed below:
  253.  
  254.            Sound Blaster 1.0 - The original.  Mono FM. Comes with CMS
  255.             chips. 100% AdLib, GameBlaster compatible plus
  256.                         mono 8 bit DAC 4kHz-23kHz / ADC 4kHz-12Khz.
  257.  
  258.           Sound Blaster 1.5 - Same as above but they made the CMS
  259.             chips optional (CMS chips are required for
  260.             GameBlaster compatibility).
  261.  
  262.           Sound Blaster 2.0 - Same as above but the CMS support was
  263.             dropped completely (Seems they weren't selling).
  264.  
  265.           Sound Blaster Pro - Same as Sound Blaster 2.0 but adds
  266.                         stereo support.
  267.  
  268.           Sound Blaster 16 - Same as Sound Blaster 2.0 buts adds
  269.                         both stereo and 16-bit support.
  270.  
  271.      Digital Audio Time 1.0 should work properly with all five
  272.      types.  If you have any problems, please let us know. 
  273.  
  274.      Various Sound Blaster clones have been produced with
  275.      different levels of compatibility.  Digital Audio Time 1.0
  276.      should work with any Sound Blaster clone with 100% register
  277.      level compatibility.  If you have any problems, please let us
  278.      know.  If you are unable to get DATIME working with your Sound
  279.      Blaster clone, you can try the AdLib FM option "-a".
  280.  
  281.      AdLib Personal Computer Music System
  282.  
  283.      AdLib produced the first sound card with 9 FM voices.  But,
  284.      it has no direct digital audio support.  We have come up with
  285.      an algorithm that allows playing of digital audio sounds on
  286.      the AdLib with surprisingly good results. 
  287.  
  288.      Disney Sound Source
  289.  
  290.      The Disney Sound Source is a parallel port Digital to Analog
  291.      Converter (DAC).  Currently DATIME only supports this device
  292.      when it is connected to LPT1 (the first parallel port).  The
  293.      sounds that came with ours were really grotty and are not
  294.      representive of the really good digital sound this device can
  295.      produce.
  296.  
  297.      PC Speaker
  298.  
  299.      The PC's speaker is a truly amazing beast.  Orignally
  300.      designed to only produce beeps and simple tones, it can
  301.      actually perform an amazing range of sounds.  However, one
  302.      has to have a speaker with sufficent volume to be heard.  On
  303.      our 16Mhz machine, the speaker is buried behind a solid front
  304.      and is not loud enough.  Our 25Mhz, on the other hand, the
  305.      speaker's sound is quite acceptable.
  306.  
  307.      DOCUMENTATION AND ACKNOWLEDGEMENTS
  308.  
  309.      If you have a printer, please print out and read this
  310.      documentation file DATIME.DOC.  This idea came to Allen one
  311.      day while he was combing through a set of sound files he had
  312.      downloaded from somewhere.  In that set were all the sounds
  313.      he needed to make this program.  Thanks to the anonymous
  314.      person for making the set available.
  315.  
  316.      We would like to thank Bob Chrisp for his information that
  317.      DAFORT (our random sound player) worked as an external alarm
  318.      player for Telemate.  DATIME works also -- see DATALARM.DOC
  319.      for more information.  If anyone knows of a similar way that
  320.      DATIME can be used in another package, please let us know.
  321.      We will give you credit here.
  322.  
  323.      NEAR FUTURE ENHANCEMENTS
  324.  
  325.      It is really silly for it to say XX:00 for XX o'clock.  But we
  326.      did not have a "o'clock" phrase that matched the others.  The
  327.      same goes for "AM".
  328.  
  329.      We would like to add support for the Covox Speach Thing and
  330.      clones.  This should be in the next release.  We know how to
  331.      do it, but do not have one to test with. If anyone has one
  332.      and would like to be an alpha tester or if you would sell us
  333.      one cheap, please let us know.
  334.  
  335.      We would like to add support for other sound cards including
  336.      Pro Audio Spectrum 16 and the MediaVision Ultrasound.  If you
  337.      have programming information on these devices, contact us,
  338.      maybe we can work a deal.
  339.  
  340.      FAR FUTURE ENHANCEMENTS
  341.  
  342.      Is anyone interested in military time?  The PC's time clock
  343.      runs a 24 hour clock and has to be translated to a 12 hour
  344.      clock.  If someone could send us the offical rules for
  345.      pronouncing military time it would really help.  We would
  346.      have to analyze it and then find or sample a sample set.
  347.      (Would offseting to ZULU time be needed also?)
  348.  
  349.      Is anyone interested in the date and time being spoken?
  350.      This would really add to the sample set.
  351.  
  352.      A really interesting idea would be to come up with a method
  353.      of allowing the user to specify his own set of samples (the
  354.      numerals 0 through 9, plus 10 though 19, and 20, 30, 40, and
  355.      50, plus the phrases "o'clock", "The time is", "AM", "PM").
  356.      One could have one's kid, spouse, boss, anybody or anything
  357.      speak the time.
  358.  
  359.      REGISTRATION BENEFITS
  360.  
  361.      Digital Audio Time 1.0 is distributed as Shareware: if you
  362.      like the program, please become a registered user by sending
  363.      $5 to TAG SOFTWARE.  List or print the file REGISTER.DOC for
  364.      more information.  List or print the file CATALOG.DOC for a
  365.      complete description of all of TAG SOFTWARE's products.
  366.  
  367.      For registering Digital Audio Time 1.0:
  368.  
  369.       - You will receive the latest registered version of this
  370.           program.
  371.  
  372.       - You will receive one FREE disk from our Digital Audio
  373.           Collection Series.  See the file CATALOG.DOC for details as
  374.     to which audio clips are on what disk. 
  375.  
  376.       - Technical Support.  Please write TAG SOFTWARE.  Or you
  377.           can contact us through The Programmer's Corner BBS
  378.     301-596-7692 or 410-995-6873. 
  379.  
  380.      As always, we will respond to your suggestions and comments.
  381.      Sometimes we can incorporate your suggestions in the latest
  382.      version of the program that you receive from us. 
  383.  
  384.